type
Post
status
Published
date
Apr 18, 2026
summary
Agent Teams 是 Claude Code 在 2026 年 2 月推出的分布式多智能体协作框架。它改变了传统“父子级”通信模式，实现了智能体之间的横向并行协作。
slug
Claude Code 高级特性 Agent Teams 原理解析
tags
AIGC应用开发
category
学习笔记
password
URL
icon
从单兵到军团：Claude Code 高级特性 Agent Teams 原理解析
导语
2026 年 2 月，Anthropic 发布了一篇重磅工程博客。文中展示了其内部如何利用 16 个 Agent 组成的团队，在短时间内从零编写了一个能够编译 Linux 6.9 内核的 Rust 语言 C 编译器。这一多智能体协作里程碑背后的核心技术，正是 Claude Code 提出的 Agent Teams 功能。
与传统的垂直型 Sub-Agent 技术（子智能体仅向主智能体汇报）不同，Agent Teams 建立了一套纵向指挥与横向协作并行的体系。队员之间拥有“信箱”系统，无需通过主智能体中转即可直接通信。
一、 协作基石：信箱系统与任务看板
Agent Teams 的工程落地主要依靠两条技术主线：
- 信箱系统 (Mailbox)：基于本地文件系统，解决队员间的点对点通信。
- 共享任务看板 (Task Board)：通过实时文件同步，解决团队的任务分配与依赖编排。
环境要求：此功能目前仅支持 Claude Opus 4.6 及以上模型。开启需在settings.json或环境变量中添加CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS。
二、 信箱系统：Agent Teams 的横向通信基础
在 Agent Teams 模式中，Anthropic 为每个队员分配了一个基于本地磁盘 JSON 文件的“信箱”。其目录结构设计极具工程参考价值：
1. 消息协议与持久化
每条消息在磁盘上以结构化 JSON 存储，包含了发送者、时间戳、已读状态以及 UI 展示元数据：
2. 通信触发：SendMessage 工具
在 Agent Teams 中，横向通信必须显式调用
SendMessage 工具。该工具负责将消息写入目标队员的 inbox 文件。为了防止并发写入冲突，系统采用了 文件锁 (Locking) 机制：在写入前加锁，读取最新内容并追加，随后释放。3. 消费机制：轮询与 XML 注入
队员通过
inbox poller 轮询自己的 inbox。当获取到新消息后，系统会将 JSON 转换为模型更易理解的 XML 标签格式 注入上下文：三、 共享任务看板：分布式协作的骨架
任务看板同样通过文件系统映射实现，每个任务对应一个 JSON 文件，存储于专用的任务目录中：
1. 任务元数据定义
任务 JSON 包含了任务的归属、状态及复杂的依赖关系：
- owner: 明确当前负责的 Agent ID。
- status: 标记为
pending、in_progress或completed。
- blocks/blockedBy: 显式描述任务间的拓扑依赖。
2. 原子化认领 (Task Claiming)
为了防止多个队员同时抢占同一任务，系统引入了原子操作。队员在认领前需校验任务状态是否为
pending、是否无 owner 以及是否已解除所有依赖（blockedBy 为空）。这些校验均在文件锁的保护下完成。四、 核心优势
- 突破上下文瓶颈：通过分布式处理，每个队员仅承载局部上下文，总处理能力成倍提升，可应对百万行级工程。
- 并发开发加速：实现多线程 Bug 修复及跨层（前端/后端/数据库）协同，提效呈非线性增长。
- 减少模型幻觉：任务颗粒度变小，配合队员间的实时 Peer Review，显著提升了代码准确率。
五、 总结
Claude Code 的 Agent Teams 并非空中楼阁，它展示了一种极其务实的工程路径：先用最稳定、可观测的机制（文件系统 + 锁 + 轮询）把协作跑起来。
它证明了多智能体协作不一定需要复杂的中心化调度服务。只要把消息通信、任务管理、状态同步、一致性保护这四件事做到实处，AI 军团就能像真实的人类工程团队一样高效运转。
最后的话：不过官方也提醒了，使用该功能，消耗的Token会大幅增加，所以大家酌情使用。目前我自己只是为了体验该功能，试用过一次，日常开发，还没遇到非他不可的场景，也许这只是一个开端，等后续模型能力提升&&成本下降后，这种方式会成为一个常态。
- 作者:luxinfeng
- 链接:https://www.luxinfeng.top/article/Claude%20Code%20%E9%AB%98%E7%BA%A7%E7%89%B9%E6%80%A7%20Agent%20Teams%20%E5%8E%9F%E7%90%86%E8%A7%A3%E6%9E%90
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。
